Ant usage for cvsgrab task

Reads a CVS repository via its ViewCVS web interface, thus avoiding any firewall problems.

Install the cvsgrab task in Ant by using the following:

<property name="cvsgrab.dir" value="[Your CVSgrab installation directory]" />

<taskdef name="cvsgrab" classname="net.sourceforge.cvsgrab.CVSGrabTask" classpath="${cvsgrab.dir}/lib/cvsgrab.jar"/>

Parameters

Attribute Description Required
urlThe url for the ViewCVS repository, copy&pasted from the browser url bar.

Example: http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/cvsgrab/?only_with_tag=RELEASE_2_2
If rootUrl and packagePath are omitted.
rootUrlThe root url for the ViewCVS repository.

Example: http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/
If url is omitted.
packagePathThe path relative to rootUrl of the package or module to download

Example: hotsax/HotSAX
If url is omitted.
projectRootThe project root, for cvs with multiple repositories.

Example: ProjectTools
No.
tagThe version tag of the files to download.

Example: BRANCH_3_0
No.
webInterfaceThe id for the web interface for the CVS repository to use. If this option is not set, autodetect the web interface.

Example: ViewCvs0_9

Call cvsgrab -listWebInterfaces to get a list of valid values for this option.
No.
destDirThe destination directory for the files retrieved from CVS. Default is the current directoryNo.
packageDirThe name of the package to use locally, relative to destDir, overrides packagePath

Example: HotSAX
No.
cvsRootThe original cvs root, used to maintain compatibility with a standard CVS client.

Example: :pserser:anonymous@cvs.apache.org:/cvsroot/public
No.
pruneEmptyDirsPrune (remove) the empty directories. Default is falseNo.
cleanUpdatePerforms a clean update. Locally modified files are backed-up, and the latest version of the file is downloaded. Default is falseNo.
verboseVerbosity. Default is not verbose. Values are true or falseNo.
connectionsThe number of simultaneous connections to open for downloads. Default is 1No.

Nested Elements

proxy

Optional. To configure how to use a proxy if you are behind a firewall that uses proxies.

Usually, it solves the 404 and 407 errors you may encounter.

Attribute Description Required
hostThe host name for the proxyYes.
portThe port of the proxy.Yes.
ntdomainThe NT domain for authentification on MS proxy.No.
usernameThe username used to login in the proxy.No.
passwordThe password used to login in the proxy.

If this option is omitted, then cvsgrab will prompt securely for the password.
No.

web

Optional. To configure authentification on the web server that hosts the cvs web interface.

Attribute Description Required
usernameThe username used to login in the web server.No.
passwordThe password used to login in the web server.

If this option is omitted, then cvsgrab will prompt securely for the password.
No.